home *** CD-ROM | disk | FTP | other *** search
/ Software of the Month Club 1996 December / Software of the Month Club 1996 December.iso / pc / dos / edu / orchis / chapt1.txt < prev    next >
Encoding:
Text File  |  1996-08-31  |  14.1 KB  |  266 lines
  1. <Chapter 1:  Introduction>
  2.  
  3. Copyright (c) 1996 Trionum Inc. All rights reserved.
  4.  
  5. ORCHIS, TRIONUM and PEP are trademarks of Trionum Inc. All other brand
  6. and product names are trademarks or registered trademarks of their
  7. respective companies.
  8.  
  9. <Section 1.1:  What is ORCHIS?>
  10.      The name ORCHIS stands for "Org Chart Imaging Software". ORCHIS makes
  11. it easy to create and maintain org charts. An org chart is a picture of a
  12. tree-like hierarchy. The most common use for such charts is to represent
  13. the structure of an organization by a diagram of who reports to whom, but
  14. there are many other applications. For example, org charts can represent
  15. menu structures, decision trees, sentence parsings, or taxonomies of
  16. plants and animals. With ORCHIS, pictures of these charts can be displayed
  17. on your computer's monitor, printed on your printer, and saved in graphic
  18. files compatible with other software packages.
  19.  
  20.      ORCHIS eliminates the necessity of actually drawing these charts
  21. yourself. Using simple data forms, you enter text for each chart element
  22. and specify its properties, such as type face and color. Using the
  23. graphical EDIT-CHART display <[2]>, you identify how the chart elements
  24. are linked together. The layout and drawing of the chart is done
  25. automatically by ORCHIS. Later, you can easily add to the chart, or change
  26. the text, properties, or linkages, and have ORCHIS instantly redraw the
  27. chart to your new specifications.
  28.  
  29. <Section 1.2:  Getting Started>
  30.      In order to install and use ORCHIS, you will need to be familiar with
  31. the basic commands of the DOS operating system. If you have any questions
  32. about using DOS, consult your operating system manual.
  33.  
  34. <Section 1.2.1:  Hardware and Software Required>
  35.      In order to run ORCHIS you need an IBM PC compatible computer running
  36. DOS 2.0 or a later version of DOS. You also need a color VGA display. You
  37. do not need a hard disk, or a mouse, but both of these are recommended.
  38.  
  39.      In order to print directly from ORCHIS, you need one of the following
  40. printers: an HP DeskJet, an HP LaserJet, a Canon Bubble Jet, a Postscript
  41. printer such as the Apple LaserWriter, an Epson printer, an IBM graphics
  42. printer, an IBM Color Printer, or a printer compatible with one of these.
  43.  
  44.      You can output pictures from ORCHIS to PDL files (the format of
  45. TRIONUM's drawing program, PEP: Picture Editing Package) <[7.1]>, to PCX
  46. files (a popular bitmap format) <[7.3]>, and to EPS files (the
  47. encapsulated Postscript format) <[7.2]>. Many word processors and desktop
  48. publishing packages accept graphics in these formats. Charts created in
  49. ORCHIS can be included, in this way, into documents, presentations and
  50. slide shows created by any of these compatible packages.
  51.  
  52. <Section 1.2.2:  Installation>
  53.      Before you can use ORCHIS, you must identify the kind of printer that
  54. you have and how it is connected to your computer. The utility INSTALL.EXE
  55. supplied with ORCHIS will guide you through this simple installation
  56. process. To be able to use ORCHIS, you must first run INSTALL. Full
  57. instructions for installing ORCHIS are provided in Chapter <[12]>.
  58.  
  59. <Section 1.2.3:  About this Manual>
  60.      In the present chapter, we provide the definitions and background
  61. information necessary to understand the chapters that follow. We recommend
  62. that you read this chapter before trying to use ORCHIS. Then if you need
  63. information about a particular command, you will be ready to turn directly
  64. to the relevant section in the reference chapters that follow.
  65.  
  66.      After this introductory chapter, is the main part of the ORCHIS
  67. manual, namely the individual command descriptions in Chapters <[2]>
  68. through <[10]>. In those chapters, you will find a complete explanation of
  69. each of the commands available in ORCHIS.
  70.  
  71.      Chapter <[11]> describes the HELP system, which allows you to view
  72. the information in this manual, on your computer's display, while you are
  73. using ORCHIS. Because the HELP system is context sensitive and includes a
  74. cross-reference facility, it is often a more convenient method of learning
  75. about ORCHIS than referring to the physical manual would be.
  76.  
  77. <Section 1.2.4:  Some Terminology>
  78.      The individual nodes that make up an org chart are simply called
  79. boxes. Each box contains one or more text lines, sometimes simply call
  80. lines. The boxes have a hierarchical ordering relation shown by the
  81. relative positions of the boxes when the chart is drawn and the lines
  82. drawn between them called links. The ordering relation has the structure
  83. of a tree, but charts are drawn upside down, with the root of the tree at
  84. the top and leaves at the bottom. <[FIG16]> shows three typical examples
  85. of such charts.
  86.  
  87.      The relationship between a subordinate box and the box above it (for
  88. example, the relationship of boxes 2 and 1 in the any of the charts above)
  89. can be described in any one of the following ways:
  90.  
  91.      1 is over 2.
  92.      2 is under 1.
  93.      1 is the parent of 2.
  94.      2 is a daughter of 1.
  95.  
  96. We also say that two daughters of one parent (for example boxes 2 and 3,
  97. or boxes 6 and 7 in any of the illustrations) are sisters.
  98.  
  99. <Section 1.3:  Menus and Commands>
  100.      ORCHIS commands are presented in a series of menus organized into a
  101. menu hierarchy. The menu that is displayed when you first load ORCHIS is
  102. called the top menu. Most of the commands in this menu cause new menus to
  103. be displayed. In some cases, these new menus have commands leading to yet
  104. other menus.
  105.  
  106.      In all of these menus, one letter in each command is underlined. To
  107. execute a command, just type this letter. Alternatively, you can point to
  108. a menu item with the cursor. Then, if you press the left mouse button (or
  109. the ENTER key on your keyboard), the selected command will be executed.
  110.  
  111. For example, in the top menu, if you type "X" (for "Export"), a new menu
  112. will appear as shown in <[FIG02]>. This new menu lists the file formats
  113. available for exporting org chart images. If you now type "E" (for "EPS")
  114. you will export the chart to a file in the Encapsulated PostScript format.
  115. (See Chapter <[7]> for complete information on file export options.)
  116.  
  117. <[FIG15]> is a chart of the principal menus in ORCHIS.
  118.  
  119. <Section 1.4:  Windows>
  120.      The ORCHIS screen is divided into three windows: a menu window, a
  121. text window, and a chart windows. The menu window is used by ORCHIS to
  122. display its commands. The text window is used for prompts and error
  123. messages. The chart window is used either to display a data entry form for
  124. one org chart box or to display the chart itself. <[FIG10]>
  125.  
  126.      A different screen layout is used when you are in the HELP system.
  127. For more information see Chapter <[11]>.
  128.  
  129. <Section 1.5:  Data Entry Forms>
  130.      When you load a chart into ORCHIS, the initial display in the chart
  131. window is a data entry form for one box of that chart. Such forms are the
  132. tools you use to change the text contents and properties of the various
  133. boxes in the chart. A typical data entry form is shown in <[FIG17]>.
  134.  
  135.      To change a line of text, activate its entry field by using the TAB
  136. key or by clicking on the field with the cursor. To display a property
  137. sheet for the box or for any one of its text lines, click on the
  138. appropriate [P]-button. You can also access property sheets through the
  139. PROPERTIES command in the top menu. For more information on using property
  140. sheets see Chapter <[3]>.
  141.  
  142.      The data entry form lists the boxes linked to the current box. To
  143. switch to the entry form for another box, either use the left, right, up,
  144. and down goto buttons in the data entry form, or display the entire chart
  145. by using the EDIT-CHART command <[2]> and then select the new box with the
  146. EDIT-BOX command <[2.1]>. Invoking EDIT-CHART also provides access to the
  147. commands for creating, deleting, linking and unlinking boxes. See Chapter
  148. <[2]> for more information on these commands.
  149.  
  150. <Section 1.6:  Scroll Bars>
  151.      A scroll bar is a tool for using the mouse to move the view in a
  152. given window. In ORCHIS, scroll bars may appear in the menu window, in the
  153. chart window, or (if you are in the HELP system) in the help document
  154. window. In this section, we will assume that you have a mouse. (If you do
  155. not have a mouse, there are commands for adjusting window views from the
  156. keyboard. See Chapter <[10]> for the single keystroke commands relevant to
  157. the chart window and the menu window. See Chapter <[11]> for the commands
  158. relevant to the help document window.)
  159.  
  160.      Scroll bars will be automatically created in the menu window, the
  161. chart window, and the help document window whenever they are needed. For
  162. example, the LOAD-CHART command <[5.1]> displays a menu of all available
  163. org chart files. If there is not enough room in the menu window to display
  164. all of the file names, a horizontal scroll bar is created at the bottom of
  165. the window. You can use this bar, as described below, to control which
  166. part of the file name list is to be displayed. In the chart view window,
  167. two scroll bars are required, a horizontal bar to control left/right
  168. motion and a vertical bar to control up/down motion.
  169.  
  170.      A scroll bar contains three buttons, an arrow button at either end
  171. and an unmarked button that can moved freely along the bar between these.
  172. This latter button is called the slider. The position of the slider shows
  173. the current location of the window view in its range of possible
  174. positions. The size of the slider shows what fraction of the range is
  175. currently visible in the window. For example, when you shrink a chart
  176. window (so that twice as much is displayed in it), the sliders expand to
  177. twice their former size.
  178.  
  179.      To adjust the window view by a small amount, click on the appropriate
  180. arrow button. One click will move a menu window or a help document window
  181. up or down by a single line of text. A graphic window will be moved by a
  182. small fraction of the total range of motion. If you hold down an arrow
  183. button (that is, you click on it and do not release the mouse button), the
  184. window motion will be automatically repeated.
  185.  
  186.      To adjust the window view by a larger amount, click on the scroll bar
  187. outside the slider (above or below the slider on a vertical bar, to the
  188. left or right on a horizontal bar). One click will move the window view by
  189. one half of the size of the window.
  190.  
  191.      If you click on the slider, the mouse becomes locked to the slider.
  192. By moving the mouse, you now move the slider. When you click a second
  193. time, the slider and the window view become fixed in their new positions.
  194.  
  195. <Section 1.7:  Moving the Cursor>
  196.      There are several ways to move the cursor in ORCHIS. These are
  197. described below.
  198.  
  199. <Section 1.7.1:  Mouse>
  200.      If you have a mouse, you can move the cursor by simply moving the
  201. mouse.
  202.  
  203. <Section 1.7.2:  Cursor Motion Keys>
  204.      The four arrow keys on the numerical key pad move the cursor in the
  205. direction of the arrow. See <[FIG09]>. These keys are also called the
  206. cursor motion keys.
  207.  
  208. <Section 1.7.3:  Automatic Motion>
  209.      If you need to move the cursor over a large distance, using the
  210. cursor motion keys can be tedious. If you do not have a mouse, you may
  211. want to use the automatic cursor motion capability. You can start the
  212. cursor moving, accelerate it, change its direction, and stop the motion
  213. when the cursor arrives at its destination.
  214.  
  215.      To start the cursor moving, press the Grey-plus key, and then press
  216. one of the cursor motion arrow keys. The cursor will begin to move at a
  217. constant speed in the direction indicated by the motion key. To make the
  218. cursor move faster, press the same key again. To change direction, press a
  219. different cursor motion key. To stop the cursor, press the Grey-plus key a
  220. second time.
  221.  
  222. <Section 1.8:  Moving Up The Menu Hierarchy>
  223.      There are three ways to move up the menu hierarchy. Most menus
  224. include an explicit QUIT or CANCEL command. This command will take you
  225. back to the previous menu, the next higher menu in the hierarchy. The
  226. second method is to use the super-escape key (function key F10)
  227. <[10.1.5]>. Pressing this key takes you in a single step to the top level
  228. menu no matter where you are in the command structure. Finally, you can
  229. use the Escape key (ESC). Pressing this key takes you back one step in the
  230. command execution. Often, ESC is equivalent to QUIT, taking you back to
  231. the prior menu. Sometimes, however, it takes you back to an earlier stage
  232. in the current operation. For example, in the EDIT-CHART menu <[2]>, when
  233. you move a box you first choose the box you want to move and then choose a
  234. new parent box for it. If you are at the second stage (choosing the
  235. parent), pressing ESC takes you back to the first stage (choosing the
  236. moving box). In any case, if you continue to press ESC, you eventually
  237. return to the prior menu and ultimately to the top level menu. If you have
  238. a mouse, pressing the right mouse button is equivalent to using the ESC
  239. key.
  240.  
  241. <Section 1.9:  More about the Mouse>
  242.      ORCHIS has been designed so that you can use a mouse if you have one,
  243. but a mouse is by no means necessary. Every function can be accessed
  244. directly from the keyboard. Cursor motion, in particular, can be
  245. controlled from the keyboard in a number of ways which have been described
  246. above.
  247.  
  248.      If you do have a mouse, pressing a mouse button is equivalent to
  249. pressing one key on the keyboard. Pressing the left mouse button is
  250. equivalent to pressing ENTER (carriage return). Pressing the right mouse
  251. button is equivalent to pressing ESC (the escape key). See <[FIG11]>. In
  252. the discussion below, we use the key names ENTER and ESC without
  253. explicitly mentioning the mouse. In each case you can use the equivalent
  254. mouse button instead.
  255.  
  256. <Section 1.10:  Org Chart Files>
  257.      ORCHIS stores org charts in files with the extension "ORG". These are
  258. pure ASCII text files using a simple context sensitive format. This simple
  259. text based format makes it easy for third party programmers to create
  260. compatible utilities, such as, for example, a program to automatically
  261. generate ORCHIS files by extracting information from a data base.
  262.  
  263.      To assist such third party developers, TRIONUM will provide a file
  264. format specification document, free of charge, to any registered user upon
  265. request.
  266.